home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 June / EnigmA AMIGA RUN 19 (1997)(G.R. Edizioni)(IT)[!][issue 1997-06][EAR-CD III].iso / for amiga / v2.1 / boot / amiboot-5.2.readme < prev    next >
Text File  |  1997-04-23  |  8KB  |  280 lines
  1.  
  2.         Linux/m68k Amiga Bootstrap version 5.2
  3.         --------------------------------------
  4.  
  5. Maintained by Geert Uytterhoeven (Geert.Uytterhoeven@cs.kuleuven.ac.be)
  6. Last revised: December 30, 1996
  7.  
  8.  
  9. 0. Introduction
  10. ---------------
  11.  
  12. Amiboot is used to boot Linux/m68k on Amiga from the CLI/Shell.
  13.  
  14. Before you try to boot Linux/m68k for the first time, please read the FAQ
  15.  
  16.     http://www-agrw.informatik.uni-kl.de/~jmayer/linux68k/linux68k-faq
  17.  
  18. and the Installation Guide
  19.  
  20.     http://www.informatik.uni-oldenburg.de/~amigo/inst.html
  21.  
  22. first. Although the Installation Guide is getting a bit outdated, it's still a
  23. good starting point.
  24.  
  25. Amiboot 5.2 is meant for Linux/m68k 2.0.x, 2.1.x or higher (kernel bootinfo
  26. interface versions 1.x and 2.x). Please use an older version for older kernels.
  27.  
  28.  
  29. 1. Running Amiboot
  30. ------------------
  31.  
  32. The Amiboot invocation syntax looks like
  33.  
  34.     amiboot [options] [kernel command line]
  35.  
  36. Basic options:
  37.  
  38.     --help           Display the usage information
  39.  
  40.     --kernel file    Use kernel image `file' (default is `vmlinux')
  41.  
  42.     --ramdisk file   Use ramdisk image `file'
  43.  
  44. Advanced options:
  45.  
  46.     --debug          Enable debug mode
  47.  
  48.     --baud speed     Set the serial port speed (default is 9600 bps)
  49.  
  50.     --memfile file   Use memory file `file'
  51.  
  52.     --keep-video     Don't reset the video mode
  53.  
  54.     --model id       Set the Amiga model to `id'
  55.  
  56.     --processor cfm  Set the processor type to `cfm'
  57.  
  58. The kernel command line contains the options you want to pass to the kernel and
  59. to init, the process that's started first by Linux. Please read
  60. linux/Documentation/m68k/kernel-options.txt for more information.
  61.  
  62. Normally you only use the --kernel option to specify the file that contains the
  63. Linux/m68k kernel image, and --ramdisk if you want to boot from a ramdisk file,
  64. i.e. a file containing a complete file system, instead of from a hard disk
  65. partition.
  66.  
  67. Example:
  68.  
  69.     amiboot -k vmlinux-2.1.13 root=/dev/hda3 video=font:PEARL8x8
  70.  
  71. Amiboot will boot the kernel image `vmlinux-2.1.13' and will pass
  72. `root=/dev/hda3 video=font:PEARL8x8' to the kernel.
  73.  
  74.  
  75. The other options are more advanced. Don't use them unless you really have to
  76. and you know what you're doing.
  77.  
  78. The --baud option allows you to specify the serial port speed for initial boot
  79. information and initial kernel messages. Note: this option does not work with
  80. kernels with bootinfo interface versions prior to 2.0.
  81.  
  82. The --memfile option is used to specify the blocks of memory that will be used
  83. by Linux.
  84.  
  85. The --keep-video option is necessary if you want to retain the current graphics
  86. mode (on a graphics board) under Linux. Currently this is only useful if you
  87. have a CyberVision 64 graphics board.
  88.  
  89. Finally, --model and --processor allow you to specify your Amiga model and
  90. processor type if they are detected incorrectly, and --debug dumps some
  91. information which simplifies debugging.
  92.  
  93.  
  94. 2. The memory file
  95. ------------------
  96.  
  97. If you have some non-AutoConfig memory you want to use under Linux, or if you
  98. want to disable some parts of your memory (e.g. Zorro II RAM on '040 based
  99. systems), you have to use a memory file and the --memfile option. This file
  100. contains information about the memory chunks you want to use under Linux. The
  101. format for the file is:
  102.  
  103.     chipramsize
  104.     [0xfastchunkaddr fastchunksize]
  105.     [0xfastchunkaddr fastchunksize]
  106.     ...
  107.  
  108. For example, if you don't want Linux to use your 2nd meg of chipram, you would
  109. create a file that contains only:
  110.  
  111.     1048576
  112.  
  113. If you had 1M of chip ram, 2M of 16 bit FAST ram at address 0x200000 and 16M of
  114. 32 bit FAST ram at address 0x80000000, and you didn't want Linux to use the
  115. slow 16 bit FAST ram, you'd create a file that looks like:
  116.  
  117.     1048576
  118.     0x80000000 16777216
  119.  
  120. The memory file can also be used to specify in which block of memory the kernel
  121. will be put. Normally Amiboot will put the kernel in the first block of Fast
  122. RAM it will find. If you use a memory file, it will put the kernel in the first
  123. block of fast RAM you specify.
  124.  
  125.  
  126. 3. Amiga models
  127. ---------------
  128.  
  129. If Amiboot incorrectly detects the model of your Amiga, you can force it to
  130. detect any model you want using the --model option. `id' must be one of the
  131. numbers as defined in linux/include/asm-m68k/amigahw.h (AMI_*). Currently the
  132. following models are known:
  133.  
  134.     Model        ID
  135.     -----        --
  136.     Amiga 500         1
  137.     Amiga 500+         2
  138.     Amiga 600         3
  139.     Amiga 1000         4
  140.     Amiga 1200         5
  141.     Amiga 2000         6
  142.     Amiga 2500         7
  143.     Amiga 3000         8
  144.     Amiga 3000T         9
  145.     Amiga 3000+        10
  146.     Amiga 4000        11
  147.     Amiga 4000T        12
  148.     CDTV        13
  149.     CD32        14
  150.     Draco        15
  151.  
  152. Note that Amiboot can't distinguish among Amiga models that are very similar to
  153. each other (e.g. A500/A1000/A2000/A2500 and A3000/A3000T). Of course this is
  154. harmless and there's no real need to use --model in that case.
  155.  
  156. Please send me the output of amiboot used with the --debug option if your Amiga
  157. model is detected incorrectly.
  158.  
  159.  
  160. 4. Processor types
  161. ------------------
  162.  
  163. If your processor is detected incorrectly, you can override this using the
  164. `--processor cfm' option. `cfm' must be a three-digit number with
  165.  
  166.   - `c' the CPU (Central Processing Unit) type,
  167.   - 'f' the FPU (Floating Point Unit) type,
  168.   - 'm' the MMU (Memory Management Unit) type,
  169.  
  170. from the table below:
  171.  
  172.      value |  CPU  |  FPU  |  MMU
  173.     -------+-------+-------+-------
  174.        0   |   -   |   -   |   -
  175.        1   | 68020 | 68881 | 68851
  176.        2   | 68030 | 68882 | 68030
  177.        3   | 68040 | 68040 | 68040
  178.        4   | 68060 | 68060 | 68060
  179.  
  180. e.g. `444' if you have a 68060 and `303' if you have a 68LC040.
  181.  
  182. Note that normally you don't have to use this option. It's only needed for some
  183. combinations of an old Kickstart ROM and a new processor (e.g. a 68060).
  184.  
  185.  
  186. 5. Abbreviations
  187. ----------------
  188.  
  189. All options also have a shorthand:
  190.  
  191.     --help         -h
  192.     --kernel        -k
  193.     A
  194.     --ramdisk        -r
  195.     --debug        -d
  196.     --baud        -b
  197.     --memfile        -m
  198.     --keep-video    -v
  199.     --model        -t
  200.     --processor        -p
  201.  
  202.  
  203. 6. Miscellaneous
  204. ----------------
  205.  
  206. Some expansion boards keep on generating interrupts once they were initialized
  207. under AmigaOS. This can cause an interrupt deadlock while booting Linux. The
  208. following boards are recognized and disabled:
  209.  
  210.     o Helfrich Rainbow 3 Graphics Board
  211.     o Helfrich Piccolo Graphics Board
  212.     o Helfrich SD64 Graphics Board
  213.     o Village Tronic Ariadne Ethernet Board
  214.     o Hydra Systems Amiganet Ethernet Board
  215.  
  216. The following boards are known to cause problems but we don't have a disable
  217. routine for them yet:
  218.  
  219.     o Commodore A2060 Arcnet Card
  220.     o Ameristar A560 Arcnet Card
  221.  
  222. If you write a routine to disable an expansion board, please let me know.
  223.  
  224.  
  225. 7. Troubleshooting
  226. ------------------
  227.  
  228.   - Amiboot says
  229.  
  230.     This bootstrap is too old/new for this kernel
  231.  
  232.     This means that you're using a version of Amiboot that's not compatible
  233.     with the kernel you want to boot.
  234.  
  235.     Solution: use the correct Amiboot, or use another kernel.
  236.  
  237.   - Amiboot says
  238.  
  239.     Warning: too many AutoConfig devices. Ignoring device at 0x????????
  240.  
  241.     or
  242.  
  243.     Warning: too many memory blocks. Ignoring block of ???K at 0x????????
  244.  
  245.     This means that you have more AutoConfig devices or memory chunks than
  246.     Amiboot supports. Note that you can still boot Linux/m68k, but that the
  247.     additional devices or memory blocks can't be used.
  248.  
  249.     Solution: increase the ZORRO_NUM_AUTO (for AutoConfig devices) or
  250.     NUM_MEMINFO (for memory chunks) values in the kernel sources
  251.     (linux/include/asm-m68k/zorro.h and linux/include/asm-m68k/setup.h) and
  252.     recompile both Amiboot and the kernel.
  253.  
  254.   - If all you get is a grey screen, or if Linux/m68k suddenly locks up during
  255.     booting, try the following things:
  256.  
  257.       o Boot with the Startup-Sequence disabled, run SetPatch and try again.
  258.  
  259.       o If that doesn't work, remove any expansion devices and retry.
  260.  
  261.       o Check the detected Amiga model and processor type.
  262.  
  263.       o Look at the characters that are dumped to the serial port during
  264.     booting.
  265.  
  266.  
  267. 8. Amiga-Lilo
  268. -------------
  269.  
  270. Once you have a stable Linux/m68k installation, you may want to try Amiga-Lilo.
  271. Amiga-Lilo allows you to boot Linux/m68k without the overhead of booting
  272. AmigaOS first, and it provides you with a boot menu.
  273.  
  274.  
  275. 9. Credits
  276. ----------
  277.  
  278. This readme was written by Geert Uytterhoeven. A lot of information was taken
  279. from the ANNOUNCE-* files by Hamish Macdonald.
  280.